home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ShareWare OnLine 2
/
ShareWare OnLine Volume 2 (CMS Software)(1993).iso
/
comm1
/
filehunt.zip
/
FILEHUNT.DOC
< prev
next >
Wrap
Text File
|
1993-04-02
|
9KB
|
200 lines
FILEHUNT
++++++++
version 3.13, by Michael Conley
released 04/02/93 from the Charlatan's Cabin BBS, Los Angeles, CA.
FILEHUNT is designed to be run as a live DOOR program on Wildcat! 3.x and 2.x
systems. It allows your users to search through the file listings from other
BBSes, perhaps to locate a file they can't find on your system. All you need
to do is supply the listing files (you may be able to convince the other
sysops to upload them to you!) in a single-line text format. In order to
be compatible with FILEHUNT, the listing MUST have the filename beginning
in the first column, and in all capital letters:
(sample line)
FILENAME.ZIP 66k 12/19/92 A really wonderful file that must be downloaded.
Any text after the name of the file is optional and may be in any format
as long as it's all on the same line, not more than 80 characters wide.
My FLOP program can create such a file listing from the database, as can
WCPRO! for version 3.x of Wildcat!, or F-PRO! for version 2.x of Wildcat!
SETTING UP A DOOR:
==================
The Wildcat! manual and other tutorials have done a fine job of explaining
how to set up a door on your BBS. Therefore I won't re-invent the wheel by
going through all of the directory naming and batch file creating necessary
to execute FILEHUNT.
It's important to note that FILEHUNT will check the CURRENT directory (where
your DOOR program is started) for either DOOR.SYS or CALLINFO.BBS. Wildcat!
version 3.x creates DOOR.SYS; earlier versions created CALLINFO.BBS. On my
system, I have a directory called DOORS, and my batch file copies DOOR.SYS
into that directory, then change to that directory, then start FILEHUNT.
FILEHUNT also needs ENVIRONMENT VARIABLES: These are used by Wildcat! 3.x
and will be ignored by Wildcat! 2.x, but they MUST be present for each node
of your Wildcat! system in order for FILEHUNT to function properly:
SET WCPORTID=2 < put these lines in your Wildcat! startup batch file and
SET WCIRQID=3 < check to be sure they are added to your environment.
If you have a non-standard port address, you'll need to provide an additional
environment variable with the DECIMAL port address:
SET COMBASE=1016 << substitute your correct decimal port address here.
That will override the default address of the port number specified in
WCPORTID. WCIRQID will still need to be set to the correct interrupt
value. FILEHUNT supports IRQs in the range 2-15.
A sample batch file for Wildcat! version 3.x would look something like this:
REM this is a sample batch file for FILEHUNT with Wildcat! 3.x
REM this assumes you SHELL to your doors. If you TERMINATE, you
REM need to add a change-directory back to your startup directory
REM and then run your startup batch file.
ECHO OFF
COPY C:\WC30\WCWORK\NODE%WCNODEID%\DOOR.SYS C:\WC30\DOORS\DOOR.SYS
CD C:\WC30\DOORS
FILEHUNT
EXIT
A sample batch file for Wildcat! version 2.x would look something like this:
REM this is a sample batch file for FILEHUNT with Wildcat! 2.x
ECHO OFF
CD \DOORS
COPY C:\CAT\NODE1\CALLINFO.BBS C:\DOORS\CALLINFO.BBS
FILEHUNT
CD \CAT\NODE1
NODE1.BAT
Note that FILEHUNT monitors time online and Carrier Detect, and will close
and exit gracefully back to the node if the caller drops offline while in
the door.
If you're running the Wildcat! IM version, I strongly recommend Scott
Brynen's DIGIFOSSIL, a shareware fossil driver available on the MSI
bulletin board, or on the Charlatan's Cabin BBS, and many other places.
PREPARING FILEHUNT:
===================
It's necessary to create a configuration file for FILEHUNT, named FILEHUNT.CFG,
which must reside in the directory where you'll start FILEHUNT. Here is a
sample configuration file:
BBSNAME=The Charlatan's Cabin BBS
CTSCHECK=YES
FOSSIL=NO
LISTPATH=C:\QBAS\
BOARDNAME=The Best BBS In The Land
BOARDFILE=RLH.BBS
BOARDSYSOP=Hoover Guy
BOARDPHONE=(213) 555-5555
BOARDCOLUMN=5
BOARDNAME=An Even Better BBS
BOARDFILE=RLH.BBS
BOARDSYSOP=Oscar Wilde
BOARDPHONE=(818) 555-5555
BOARDCOLUMN=1
You may edit this file as desired, following these guidelines:
BBSNAME= The name of YOUR BBS as you want it to appear in
the program's displays.
CTSCHECK= Indicate YES or NO ... do you want the program to
check for Clear to Send? Default is YES if this
line isn't found.
FOSSIL= Indicate YES or NO ... do you want the program to
redirect COM calls to INT 14h? If you're not using
a FOSSIL driver, set this to NO.
LISTPATH= The complete Path to your BBS file lists.
Next, you'll need to set up configuration information for each BBS file list
you want to support in The File Hunter. NOTE: You'll need to place ALL of the
lists in the directory defined in LISTPATH.
A maximum of 18 BBS file lists may be included ... any beyond that will be
ignored.
For each BBS list, create a block of entries consisting of these four lines:
BOARDNAME= This is the name of the BBS which supplied the listing.
Up to 40 characters may be used. This will appear in
the various displays including the selection menu.
BOARDFILE= This is the exact filename of the BBS's file listing.
(Remember to place this file in the directory defined
up above in LISTPATH.)
BOARDSYSOP= This is the name of the BBS's SysOp as you want it to
appear when the search is taking place.
BOARDPHONE= This is the phone number of the BBS. I recommend that
you include the area code, such as: (213) 654-7337.
This text will appear in the selection menu and also
at the beginning of each search operation.
BOARDCOLUMN= This is the column where the file name begins. Nothing
to the left of this column is displayed, and the search
for any kind of match begins in this column.
It's important to note that the block of options for each list must be filled
out completely, or The File Hunter may produce unpredictable results! Also, be sure
to keep them in the order shown above. Do NOT omit any lines or The File Hunter
will reject the configuration file.
------------------------------------------------------------------
PROBLEMS, SUGGESTIONS:
This program is public domain. I don't seek or accept any donations for
this or any of my other Wildcat! utility programs, including TODAYBBS,
FLOP, MSTAT, USTAT, and others.
I welcome suggestions, and will try to help (no guarantees) if there are
problems.
You may contact me at The Charlatan's Cabin BBS (213) 654-7337. Mention
your Wildcat! registration number in the comment and you'll be upgraded to
visiting sysop level without the usually required registration by mail.
You may also leave a message via CompuServe EMail. My CompuServe account
number is 70250,220. I also regularly check the Mustang Software head-
quarters BBS, especially the "3rd Party Utilities Help" conference.
Please, NO VOICE CALLS. This isn't meant to be unfriendly, but with the
price of public domain software these days ... I just can't afford to be
"on call." I WILL respond to your questions via my BBS or CompuServe,
or via the Mustang Software registered SysOp BBS.
Version history:
1.00 12/08/91 First release, compatible with Wildcat! 3.x as well
as Wildcat! 2.x.
1.01 12/08/91 Minor bug fix to handle backspacing from remote when
input line is empty.
3.03 01/19/92 Revised version number to correspond with other doors.
Enabled total of 18 lists in menu. Fixed local display
erase line function if no remote online.
3.04 01/19/92 Fixed CTS checking bug.
3.05 02/07/92 Recompiled with QBSerial 2.1 by Jeff Sumberg. More
reliable on a multi-tasking machine.
3.06 07/05/92 Recompiled with QBSerial 2.25 by Jeff Sumberg.
3.10 12/19/92 Added FOSSIL support with QBSerial 3.0 by Jeff Sumberg.
3.11 01/23/93 Enhanced FOSSIL support with better checking of init
operations.
3.12 01/29/93 Bug fix in flow control under FOSSIL.
3.13 04/02/93 Added routine to clear buffer before asking for first
input in case user typed something while waiting.